home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / tools / system-tools / browserii_v3_09 / help / english / for.doc < prev    next >
Encoding:
Text File  |  1996-02-26  |  3.3 KB  |  110 lines
  1.  
  2.                                   For.doc
  3.  
  4.  
  5.  
  6.     For only works under AmigaOS 2.0 and higher.
  7.     Some features requires whatis.library
  8.  
  9.     "For"  is  a  foreach command.  For each object (file/dir) which pattern
  10. (name  pattern  or  FileType  pattern)  "For"  execute the specified command
  11. replacing all %% (maximum 5) by the name of the current file.
  12.  
  13.     Eg:
  14.  
  15.         For *.doc DO copy %% to DOC:
  16.  
  17.         Search all file ine current dir which match to *.doc and execute the
  18. command:  "copy file.doc to DOC:"
  19.  
  20.         For #? ALL Type "Icon" DO Protect %% -e
  21.  
  22.         Look  in  the  current  dir  and  subdirs for icon (.info) files and
  23. execute the command:  "Protect iconfile -d"
  24.  
  25.         For can get it's default argument in an environnement variable named
  26. "ENV:For".
  27.  
  28.  
  29. Usage: For <Patterns> [Files <MATCH|YES|NO>] [Dirs <MATCH|YES|NO>]
  30. [Since <Date>] [Before <Date>] [MinSize <Number>] [MaxSize <Number>]
  31. [PosProtect <L|C|H|S|P|A|R|W|E|D>] [NegProtect <L|C|H|S|P|A|R|W|E|D>]
  32. [Type <FileType0,,,FileType9|#=SUB|!=EXLC>] [All] [ASync] [ReadSize]
  33. [ShowBytes] [Deep] [ShowFileType] [FileTypeVar <var name>] [FullPathArgs]
  34. [DO <Command [args] [,Command [args] [,...]]>]
  35.  
  36. Pattern $Pat1 $Pat2 $Pat255: any number of pattern like
  37.     *.doc
  38.     WB:*.info More MuchMore *.doc
  39.  
  40. FILES:
  41.     MATCH:  look if file match to current pattern
  42.     YES:    include all file encounter
  43.     NO:     exclude all file encounter
  44.     default YES
  45. DIRS:
  46.     MATCH:  look if dir match to current pattern
  47.     YES:    include all dir encounter
  48.     NO:     exclude all dir encounter
  49.     default YES
  50.  
  51. Since $date:    include only file older than $date
  52.  
  53. Before $date:   include only file newer than $date
  54.  
  55. MinSise $size:  include only file bigger than $size
  56.  
  57. MaxSise $size:  include only file tyner than $size
  58.  
  59. bit C and L are special bit (not AmigaDOS)
  60.     C means file have a comment
  61.     L means file is a link
  62. PosProtect $protectbit: only include file which have this bits like
  63.     ae
  64.     srwed
  65.  
  66. NegProtect $protectbit: only include file which have'nt this bits like
  67.     a
  68.     hs
  69.  
  70. Type filetype_spec_list:
  71.  
  72.     for Template reason you must enclose your filetype_spec_list by '"'
  73. and each FileType name must be enclosed by open/close brace ()
  74. FileType  is one of the FileType of whatis.library this is not usable if
  75. have not instaled the whatis.library in your system.
  76.  
  77.     ~ means exlude this FileType
  78.     # means with its sub types
  79.  
  80.     "~#Exe"  exclude all executable files
  81.     "Icn Disk,Icn Grbg"    only include "Icn Disk" and "Icn Grbg"
  82.  
  83. ALL: enter in all sub directories
  84.  
  85. ASYNC:  this runs your command asyncrously  (default to FALSE)
  86.  
  87. READSIZE $size: $size "For" read to recognise FileType
  88.  
  89. SHOWBYTES $numbyte: byte to display, meaningfull only when SHOWFILETYPE is set
  90.  
  91. DEEP:   Choose Whatis level of Whatis.library, see whatis.library for more
  92. details.
  93.         0 = LightWhatIs  (Slow FileType Recognition, but do better result)
  94.         1 = DeepWhatIs
  95.     Default is LightWhatIs (0)
  96.     
  97. SHOWFILETYPE:  show the FileType name.
  98.  
  99. DO:   your  command  to  execute, replacing all %% (upto 5) by the current
  100. object and ',' by CR enable you doing multinple command at time.
  101.     if you dont supply a DO, SHOWFILETYPE is automaticaly enable emulating
  102. a WhatIs command.
  103.  
  104.  
  105. FILETYPEVAR:   Variable name to initialize to the last encoutered file type
  106.             (See Extract script example)
  107.  
  108. FULLPATHARGS:  Give args to 'DO' command with full path
  109.  
  110.